Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 1 - Introduction to QuickDraw 3D / QuickDraw 3D Reference

QuickDraw 3D Routines / Initializing and Terminating QuickDraw 3D

Q3Initialize

You should call the Q3Initialize function to initialize a connection to QuickDraw 3D.

TQ3Status Q3Initialize (void);

DESCRIPTION

The Q3Initialize function initializes a connection between your application and the QuickDraw 3D graphics library. QuickDraw 3D allocates whatever internal storage it needs to manage subsequent calls to QuickDraw 3D routines, and it initializes any subcomponents it needs to call. If Q3Initialize returns kQ3Failure, you should not call any QuickDraw 3D routines other than the Q3IsInitialized function or the error-reporting routines provided by the Error Manager. Calling Q3Initialize more than once results in a warning being posted but is otherwise acceptable.

SPECIAL CONSIDERATIONS

You must call Q3Initialize to create a connection to the QuickDraw 3D software before calling any other QuickDraw 3D routines.

ERRORS

kQ3ErrorAlreadyInitialized
kQ3ErrorNotInitialized
kQ3ErrorOutOfMemory